home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / ttdt_Save.z / ttdt_Save
Encoding:
Text File  |  2002-10-03  |  6.6 KB  |  132 lines
  1.  
  2.  
  3.  
  4. ttttttttddddtttt____SSSSaaaavvvveeee((((3333))))                                                      ttttttttddddtttt____SSSSaaaavvvveeee((((3333))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ttdt_Save - request a ToolTalk client to save a file
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ####iiiinnnncccclllluuuuddddeeee <<<<TTTTtttt////ttttttttttttkkkk....hhhh>>>>
  13.      TTTTtttt____ssssttttaaaattttuuuussss ttttttttddddtttt____SSSSaaaavvvveeee((((TTTTtttt____mmmmeeeessssssssaaaaggggeeee _c_o_n_t_e_x_t,,,,
  14.                          ccccoooonnnnsssstttt cccchhhhaaaarrrr ****_p_a_t_h_n_a_m_e,,,,
  15.                          TTTTtttt____ssssccccooooppppeeee _t_h_e__s_c_o_p_e,,,,
  16.                          XXXXttttAAAAppppppppCCCCoooonnnntttteeeexxxxtttt _a_p_p_2_r_u_n,,,,
  17.                          iiiinnnntttt _m_s__t_i_m_e_o_u_t))));;;;
  18.  
  19. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  20.      The ttttttttddddtttt____SSSSaaaavvvveeee() function sends a _S_a_v_e request in the _t_h_e__s_c_o_p_e argument
  21.      and waits for the reply.  A _S_a_v_e request asks the handling ToolTalk
  22.      client to save any changes pending on _p_a_t_h_n_a_m_e.
  23.  
  24.      The _c_o_n_t_e_x_t argument describes the environment to use.  If _c_o_n_t_e_x_t is not
  25.      zero, messages created by ttttttttddddtttt____SSSSaaaavvvveeee() inherit from _c_o_n_t_e_x_t all contexts
  26.      whose slotname begins with the characters EEEENNNNVVVV____.
  27.  
  28.      The _t_h_e__s_c_o_p_e argument identifies the scope of the request.  If _t_h_e__s_c_o_p_e
  29.      is TTTTTTTT____SSSSCCCCOOOOPPPPEEEE____NNNNOOOONNNNEEEE, ttttttttddddtttt____SSSSaaaavvvveeee() tries TTTTTTTT____BBBBOOOOTTTTHHHH, and falls back to
  30.      TTTTTTTT____FFFFIIIILLLLEEEE____IIIINNNN____SSSSEEEESSSSSSSSIIIIOOOONNNN if, for example, the ToolTalk database server is not
  31.      installed on the file server that owns _p_a_t_h_n_a_m_e.
  32.  
  33.      The ttttttttddddtttt____SSSSaaaavvvveeee() function passes _a_p_p_2_r_u_n and _m_s__t_i_m_e_o_u_t to
  34.      ttttttttttttkkkk____bbbblllloooocccckkkk____wwwwhhhhiiiilllleeee(3), blocking on the reply to the _S_a_v_e request it sends.
  35.  
  36. RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEE
  37.      Upon successful completion, the ttttttttddddtttt____SSSSaaaavvvveeee() function returns the status
  38.      of the operation as one of the following TTTTtttt____ssssttttaaaattttuuuussss values:
  39.  
  40.         TTTTTTTT____OOOOKKKK   The sent request received an affirmative reply within
  41.                 _m_s__t_i_m_e_o_u_t milliseconds.
  42.  
  43.         TTTTTTTT____DDDDEEEESSSSKKKKTTTTOOOOPPPP____EEEETTTTIIIIMMMMEEEEDDDDOOOOUUUUTTTT
  44.                 No reply was received within _m_s__t_i_m_e_o_u_t milliseconds.
  45.  
  46.         TTTTTTTT____DDDDEEEESSSSKKKKTTTTOOOOPPPP____EEEEPPPPRRRROOOOTTTTOOOO
  47.                 The request was failed, but the handler set the
  48.                 tttttttt____mmmmeeeessssssssaaaaggggeeee____ssssttttaaaattttuuuussss() of the failure reply to TTTTTTTT____OOOOKKKK, instead of
  49.                 a specific error status.
  50.  
  51.         TTTTTTTT____EEEERRRRRRRR____DDDDBBBBAAAAVVVVAAAAIIIILLLL
  52.                 The ToolTalk service could not access the ToolTalk database
  53.                 needed for this operation.
  54.  
  55.         TTTTTTTT____EEEERRRRRRRR____DDDDBBBBEEEEXXXXIIIISSSSTTTT
  56.                 The ToolTalk service could not access the specified ToolTalk
  57.                 database in the expected place.
  58.  
  60.  
  61.  
  62.                                                                         PPPPaaaaggggeeee 1111
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69. ttttttttddddtttt____SSSSaaaavvvveeee((((3333))))                                                      ttttttttddddtttt____SSSSaaaavvvveeee((((3333))))
  70.  
  71.  
  72.  
  73.         TTTTTTTT____EEEERRRRRRRR____NNNNOOOOMMMMEEEEMMMM
  74.                 There is insufficient memory available to perform the
  75.                 function.
  76.  
  77.         TTTTTTTT____EEEERRRRRRRR____NNNNOOOOMMMMPPPP
  78.                 The ttttttttsssseeeessssssssiiiioooonnnn(1) process is not running and the ToolTalk
  79.                 service cannot restart it.
  80.  
  81.         TTTTTTTT____EEEERRRRRRRR____OOOOVVVVEEEERRRRFFFFLLLLOOOOWWWW
  82.                 The ToolTalk service has more active messages than it can
  83.                 handle.  (The maximum number of active messages is
  84.                 implementation specific, but is at least 2000.)
  85.  
  86.         TTTTTTTT____EEEERRRRRRRR____PPPPOOOOIIIINNNNTTTTEEEERRRR
  87.                 The _p_a_t_h_n_a_m_e argument was NNNNUUUULLLLLLLL or was a ToolTalk error
  88.                 pointer.
  89.  
  90.         TTTTTTTT____EEEERRRRRRRR____PPPPRRRROOOOCCCCIIIIDDDD
  91.                 The specified process identifier is out of date or invalid.
  92.  
  93. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  94.      TTTTttttttttttttttttkkkk(5), ttttttttddddtttt____RRRReeeevvvveeeerrrrtttt(3), ttttttttddddtttt____ffffiiiilllleeee____jjjjooooiiiinnnn(3), ttttttttddddtttt____ffffiiiilllleeee____eeeevvvveeeennnntttt(3),
  95.      ttttttttttttkkkk____bbbblllloooocccckkkk____wwwwhhhhiiiilllleeee(3).
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.                                                                         PPPPaaaaggggeeee 2222
  129.  
  130.  
  131.  
  132.